<h2 id="exams">4. Exams</h2>
<div>
    This service returns a list with the student's future exams.<br />
    <b>Request URL</b><br />
    <div class="url"><?php echo $config['path']; ?>getexams.php?u=XXX&p=YYY&k=ZZZ</div><br />
    
    <b>Request Parameters</b><br />
    <table>
        <tr>
            <th>Key</th>
            <th>Name</th>
            <th>Explanation</th>
        </tr>
        <tr>
            <td>u</td>
            <td>Username</td>
            <td>The username the student uses to access FH services.</td>
        </tr>
        <tr>
            <td>p</td>
            <td>Password</td>
            <td>The password the student uses with his FH username.</td>
        </tr>
        <tr>
            <td>k</td>
            <td>FHPI Key</td>
            <td>The FHPI key of your application. <a href="<?php echo $config['path']; ?>manage/register.php">Get yours here</a>.</td>
        </tr>
    </table><br />
    
    <b>Example Result</b><br />
    <div class="sample">
        <?php
            $string = '<Overview>
<Status>OK</Status>
<Term name="5. Studiengangssemester, WS 2011">
<Exam>
<Id>exam_4314965799</Id>
<Title>Seminar Software Design</Title>
<Type>Se</Type>
<Mode>schriftlich</Mode>
<Date>10.03.2012 09:00-11:00</Date>
<RegistrationEnd>07.03.2012 23:59</RegistrationEnd>
<DateUnix>1331366400</DateUnix>
<RegistrationEndUnix>1331161140</RegistrationEndUnix>
<ExamStatus>registered</ExamStatus>
</Exam>
</Term>
</Overview>';
            echo nl2br(htmlentities($string));
        ?>
    </div><br />
    
    <b>Notes</b><br />
    <div>
        The root element of the returned document is "Overview". It can contain multiple "Term" elements which can contain multiple "Exam" elements containing all relevant information.<br />
        The fields all are self-explanatory.<br />
        Revision 22 introduces DateUnix and RegistrationEndUnix which returns the UNIX-Timestamp for the corresponding points in time. This will help app designers in the future, when internatonalizaton will be available. That way you won't have to parse dates in order to prevent e.g. signing up for an exam after registration ended.
    </div>
    
</div>